home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / actv331.zip / ACTVIEW.DOC next >
Text File  |  1992-05-19  |  16KB  |  349 lines
  1.  ---------------------------------------------------------------------------
  2.                                ACTVIEW 3.31 (c)
  3.                     Wildcat! Activity Log Viewer/Analyzer
  4.                       Copyright (c) 1992 by Greg Wilson
  5.                              All Rights Reserved
  6.                                    05/20/92
  7.                              Author: Greg Wilson
  8.  ---------------------------------------------------------------------------
  9.  
  10.                                    Purpose
  11.                                    -------
  12.  Actview was written out of my own need for a tool to assist with reading the
  13.  activity log of my BBS. The task of viewing the log with a file viewer was
  14.  taking too long and I found myself rushing through the process, missing many
  15.  important events such as system errors and invalid logon attempts.
  16.  
  17.  Actview started as a simple program that produced a one line per call report
  18.  with a few flags. After getting input from some fellow sysops, I decided to
  19.  write a complete activity log viewer!
  20.  
  21.                                  Instructions
  22.                                  ------------
  23.  For a quick look at what Actview has to offer, copy ACTVIEW.EXE to the
  24.  directory containing your activity log(s) and run it. If you have more than
  25.  one node, you will have to build a file named ACTVIEW.CFG (see below). The
  26.  program will display the last recorded day's activity in a one line per call
  27.  format with the critical information shown. At the top of the screen, the
  28.  range of dates in the log is displayed along with the date of the information
  29.  being displayed. The primary Fkey functions are displayed at the bottom of
  30.  the screen. More functions are shown in the help window (F1). The calls can
  31.  be scrolled using the arrows, home, end, page up, and page down keys. If
  32.  enter is pressed, the detail of the highlighted call is extracted from the
  33.  activity log and displayed. Important events such as invalid logon attempts,
  34.  file overwrites, etc., are highlighted.
  35.  
  36.  NEW FEATURES: Actview now allows the user to go directly to WCPro, QuesView
  37.  and the DOS prompt by pressing ALT-E. Actview is swapped to XMS/EMS/Disk
  38.  before the program is called. When WCPro/QuesView/Dos prompt is done, the
  39.  program returns to exactly where you left off! This functions can be called
  40.  from anywhere within Actview. >REGISTRATION IS REQUIRED<
  41.  
  42.  
  43.  Key     Function
  44.  ------------------------------------------------------------------------
  45.  F1    - Displays the help window.
  46.  F2    - Swaps to another node's log. Directories to your different logs must
  47.          be entered in a file named ACTVIEW.CFG (see below).
  48.  F3    - Displays the following activity:
  49.          * Events
  50.          * Wildcat system errors such as files missing.
  51.          * Changes to the user's record such as changing birth dates,
  52.            passwords, ..etc.
  53.          * File overwrites.
  54.          * Invalid logon attempts. When detail is viewed for invalid logon
  55.            attempt, the next call is displayed for reference.
  56.          To return to the normal display, hit escape.
  57.  F4    - Displays totals for the currently displayed date.
  58.  F5    - Displays new users for the day showing their city and state.
  59.          To return to the normal display, hit escape.
  60.  F6    - Allows jumping directly to any date in the activity log.
  61.  
  62.  F7    - Jumps to the previous day's activity.
  63.  F8    - Jumps to the next day's activity.
  64.  F9    - Displays all calls of a specified user. The program will prompt for
  65.          user name, beginning date, and ending date of search. The name will
  66.          default to the highlighted call. The dates will default to the
  67.          beginning and end of the activity log. Actview will scan the log
  68.          finding all matching calls and then display the calls in the usual
  69.          one line per call format. To view totals for the user, hit F4. To
  70.          return to the normal display, hit Escape. To abort the search, press
  71.          the space bar.
  72.  F10 or ALT-X - Quits to DOS.
  73.  ALT-E - External program menu. This option allows Actview to call WCPro,
  74.          QuesView and shell to DOS. Actview is swapped to XMS/EMS/DISK. This
  75.          features requires registration.
  76.  ALT-L - Toggles local calls. Local calls will not be displayed or
  77.          included in the daily counts.
  78.  ALT-S - Allows the entire activity log(s) to be searched for a given string
  79.          (such as filename, Message#, ..etc.). Here are some ways I use this
  80.          feature:
  81.          * Search for all activity related to a particular file.
  82.          * Search for all activity related to a bulletin or door.
  83.          * Find all users that still use XMODEM.
  84.          * See who is using TomCat.
  85.          * See who has exceeded their time limit.
  86.          * ...etc.!
  87.  ALT-D - View all downloads for the day.
  88.  ALT-U - View all uploads for the day with descriptions (if available).
  89.  ALT-O - Sort calls. Actview will display a menu of 7 different sort types.
  90.          This function also works while viewing downloads and uploads.
  91.  ALT-V - View all activity logs for all nodes. Every log in the ACTVIEW.CFG
  92.          file is scanned for the currently displayed date and the calls are
  93.          loaded. This is a major time saver!
  94.  
  95.  
  96.  A typical Actview session would go something like:
  97.  
  98.       * Type ACTVIEW (if multi-node use the VIRT parameter to load all logs).
  99.       * Hit F3; if any errors are displayed, view the detail.
  100.       * Hit F5; view new users.
  101.       * Hit ALT-U to see what was uploaded.
  102.       * Hit ALT-D to see what was downloaded.
  103.       * Hit ESC to go back to viewing all calls.
  104.       * Scroll though the summary looking for uploads, msgs, carrier
  105.         drops and pages viewing the detail of these activities if desired.
  106.       * At any time, from any screen, WCPro and QuesView can be called (ALT-E).
  107.  
  108.  
  109.  An average review takes me about 2 minutes compared to 20 minutes before
  110.  I had ACTVIEW!
  111.  
  112.                               User Defined Flags
  113.                               ------------------
  114.  
  115.  Actview allows sysops to define flags to indicate that a certain activity
  116.  has occurred during a call. These one character flags are displayed on the
  117.  initial call summary screen and are defined in the file ACTVIEW.FLG. This has
  118.  many uses including:
  119.  
  120.                 * Flag all users that download a certain file
  121.                 * Flag all users that use a certain door
  122.                 * Flag all users that drop carrier
  123.                 * Flag all users that exceed their download ratio
  124.                 * Flag all users that leave a message in a certain folder
  125.                 * Flag all users that complete a certain questionnaire
  126.                 * .. etc.
  127.  
  128.  A flag is a single character to be displayed in the flag column on the
  129.  summary screen. Up to 5 flags can be displayed for a single call. If more
  130.  than 5 flags are found, the last flag will be then character "*". Also, when
  131.  viewing the detail of a call, any lines that contain the flag string will be
  132.  highlighted. In the ACTVIEW.FLG file, the first column contains the flag
  133.  character to be displayed. The string to turn on the flag is enclosed in
  134.  quotes on the same line as the flag character.
  135.  
  136.  Example: If an additional flag was desired to show any activity related to
  137.  the file "FILELIST.ZIP", ACTVIEW.FLG would be updated as follows (remember
  138.  that the flag characters must be in column 1):
  139.  
  140.                                E "ERROR"
  141.                                C "DROPPING CARRIER"
  142.                                D "OVER DOWNLOAD RATIO"
  143.                                M "MNP:YES"
  144.                                F "FILELIST.ZIP"
  145.                                V "ACTVIEW.ZIP"
  146.  
  147.                      ***    Note: Case is ignored    ***
  148.  
  149.  See the file ACTVIEW.FLG for more examples. The initial flags for dropping
  150.  carrier, errors, new users, and exceeding download ratio are already set up.
  151.  
  152.  
  153.  
  154.  
  155.                              Multi Node Features
  156.                              -------------------
  157.  
  158.  For multi-node operation, create a file named ACTVIEW.CFG with the
  159.  directories and filenames in the following format: (in column 1)
  160.  
  161.                              C:\WC30\ACTIVITY.001
  162.                              C:\WC30\ACTIVITY.002
  163.                              C:\WC30\ACTIVITY.003
  164.                              C:\WC30\ACTIVITY.004
  165.  
  166.  The entire path *and* filename must be specified in each line.
  167.  
  168.  NOTE: ACTVIEW.CFG must be in the same directory as ACTVIEW.EXE
  169.  
  170.  This feature may also be useful for single node sysops that maintain backup
  171.  copies of their logs under other names and/or directories and still want to
  172.  access them via Actview.
  173.  
  174.  NOTE: Actview only opens the ACTIVITY.LOG when needed and closed the file
  175.  during all other activities therefore allowing Wildcat to keep writing to the
  176.  log without any type of share violation. This greatly increases the
  177.  reliability of Actview when using on a log that is currently active. This
  178.  also gives the ability to view the current callers activity to see what
  179.  he/she just did.
  180.  
  181.  
  182.  
  183.                               Actview parameters
  184.                               ------------------
  185.  
  186.           ACTVIEW mm/dd/yy NOLocal ERRors NEW NODE=x MONO SNOW BIOS
  187.  
  188.             mm/dd/yy - Go directly to mm/dd/yy.
  189.             HELP     - Display help screen.
  190.             NOLocal  - Do not show local calls (ALT-L toggles).
  191.             ERRors   - Show errors for the day (F3 toggles).
  192.             NEW      - Show new users only (F5 toggles).
  193.             NODE=x   - Go to node x. ACTVIEW.CFG must be present.
  194.             MONO     - Force monochrome attributes.
  195.             NOMOUSE  - Turn Off Mouse support (speeds up entry and exit).
  196.             SNOW     - Turn on snow checking during screen writes.
  197.             VIRT     - View all nodes at once (ACTVIEW.CFG required).
  198.             BIOS     - Use bios screen writes. This option is not necessary
  199.                        when running Actview under Desqview because checks for
  200.                        Desqview are made and direct screen writes are
  201.                        re-mapped accordingly. BIOS writes are much slower than
  202.                        the normal direct screen writes and should not be used
  203.                        unless necessary.
  204.             25       - Set 25 line mode
  205.             43       - Set 43 line mode (EGA)
  206.             50       - Set 50 line mode (VGA)
  207.  
  208.  
  209.  
  210.                            Requirements and Limits
  211.                            -----------------------
  212.  * ACTVIEW has been tested with the activity logs created by Wildcat 
  213.    3.50, 3.02, 3.01, 3.0, 2.55, 2.50, 2.15, 2.0 and the Wildcat Test Drive!
  214.  
  215.  * ACTVIEW is Desqview aware. No extra parameters are needed.
  216.  
  217.                       Memory requirements: 220k (Multi node see note)
  218.                  Max nodes in ACTVIEW.CFG: 100
  219.                                 Max flags: 100
  220.  
  221.   Max number of displayed calls is now only limited by the available memory.
  222.   The max number is displayed in the help window. This is also the max number
  223.   of hits when searching (ALT-S or F9). If the search finds more than the
  224.   available number of displayed calls, a message will be displayed and the
  225.   search will be halted.
  226.  
  227.   Multi-node note: If your BBS receives a lot of calls each day, more memory
  228.   will be needed to view the calls. With 180k, only about 400 calls per day
  229.   are allowed to be viewed at once. The max number of calls is displayed in
  230.   the help window.
  231.  
  232.  * Actview opens the ACTIVITY.LOG's in READ ONLY mode. *No* writes are made to
  233.    *any* files (except a swap file during external program calls (ALT-E)).
  234.  
  235.                                   Liability
  236.                                   ---------
  237.  
  238.  Actview has been tested on multiple machines using many different
  239.  configurations and no problems have occurred. However, if a problem does arise
  240.  due to Actview, I cannot be held responsible. Use at your own risk.
  241.  
  242.  
  243.  
  244.                         Distribution and Registration
  245.                         -----------------------------
  246.  
  247.  Actview may be freely distributed only as the following unaltered files:
  248.  
  249.                                  ACTVIEW.EXE
  250.                                  ACTVIEW.FLG
  251.                                  ACTVIEW.DOC
  252.                                  ACTVIEW.HIS
  253.                                  READ.ME
  254.                                  REGISTER.DOC
  255.  
  256.  
  257.  ACTVIEW is  not free. You must register after the 30-day evaluation time
  258.  period.
  259.  
  260.  ACTVIEW is a Shareware product.  It is distributed through public access
  261.  channels so that perspective buyers can have the opportunity to evaluate the
  262.  product before making a  decision to buy. If you decide to use this software,
  263.  then you are under both legal and moral obligation to register it with the
  264.  author. But if you decide not to use it after evaluating the software, you
  265.  are under no obligation. It is fully protected by State, Federal and
  266.  International copyright laws.
  267.  
  268.  If you continue to use ACTVIEW after the 30-day evaluation time period you
  269.  must register it.
  270.  
  271.                             Registration Fee  : $25 US
  272.  
  273.  Why Register?
  274.  --------------------------------------------------------------------
  275.  * The external call menu is enabled (ALT-E)
  276.  * All opening and closing screens are removed!
  277.  * Registered users have access to the Actview support BBS is granted!
  278.  * All Actview reports can be downloaded from the support BBS!
  279.  * All future updates are free!
  280.  
  281.  To register ACTVIEW, complete in the order form (REGISTER.DOC) and mail along
  282.  with your check or money order payable to "Greg Wilson" to:
  283.  
  284.  
  285.          ==========================       ==========================
  286.          >>    After 06/05/92    <<       >>    Before 06/05/92   <<
  287.          ==========================       ==========================
  288.          Greg Wilson                      Greg Wilson
  289.          1252 Fordham Drive #101          1427 Valley Lake Dr. #1228
  290.          Glendale Heights, Il 60139       Schaumburg, Il 60195
  291.  
  292.             BBS: 708-752-4303                BBS: 708-882-1060
  293.  
  294.  ██████████████████████████████████████████████████████████████████████████████
  295.                 * Credit Card Orders (VISA/MC/Discover/Amex) *
  296.  ██████████████████████████████████████████████████████████████████████████████
  297.  
  298.          Visa/MC/Amex/Discover (via the Public Software Library):
  299.  
  300.                         1-800-2424-PSL or 713-524-6394
  301.                         FAX: 1-713-524-6398
  302.                         CIS Email: 71355,470
  303.  
  304.                                 Product #10407
  305.  
  306.                     Credit card Price is $25 + $3 handling
  307.  
  308.                       THESE NUMBERS ARE FOR ORDERS ONLY!
  309.  
  310.                Do not call these numbers for technical support!
  311.  
  312.       All orders are relayed back to me the same day the order is made.
  313.  
  314.     The registered version can be shipped, uploaded or downloaded from my
  315.                             BBS or via CompuServe.
  316.  
  317.  ██████████████████████████████████████████████████████████████████████████████
  318.  
  319.  
  320.  
  321.                                    Credits
  322.                                    -------
  323.  Swapping of Actview to XMS/EMS/Disk was built using SPAWNO v4.1 by Ralf
  324.  Brown
  325.  
  326.  Screen I/O, data entry screens and popup windows were built using TCXL by
  327.  Innovative Data Concepts
  328.  
  329.  
  330.  
  331.                             Contacting the Author
  332.                             ---------------------
  333.  
  334.  I can be reached for comments, questions, suggestions, complaints, etc., at
  335.  the following EMAIL boxes:
  336.  
  337.  
  338.           My BBS            (SYSOP)            - mail checked daily
  339.           Mustang BBS       (GREG WILSON)      - mail checked daily
  340.           The Source        (GREG WILSON)      - mail checked daily
  341.           CompuServe        (76547,3106)       - mail checked daily
  342.           EXEC-PC           (GREGORY WILSON)   - mail checked daily
  343.           Channel 1         (GREG WILSON)      - mail checked daily
  344.           PC-Ohio           (GREG WILSON)      - mail checked daily
  345.           Executive Network (GREG WILSON)      - mail checked daily
  346.  
  347.  
  348.                                     -end-
  349.